home *** CD-ROM | disk | FTP | other *** search
/ Alde ADA 5 #1 / ADA CD-ROM - Alde Publishing.iso / cm / vlngthio.sid < prev    next >
Encoding:
Text File  |  1988-05-03  |  4.0 KB  |  82 lines
  1. --= SID = SIMTEL20 Ada Software Repository Item Description File = SID =--
  2. -- UNIT NAME         : VARIABLE_LENGTH_DIRECT_IO
  3. -- VERSION           : 1.0
  4. -- REVIEW CODE       : 
  5. -- DDN ADDRESS       : WOODY%TI-EG@CSNET-RELAY
  6. -- AUTHOR            : Patrick Kopson 
  7. --                   : Texas Instruments  
  8. -- COPYRIGHT         : (c) 1985
  9. -- DATE CREATED      : 01 APR 85
  10. -- DATE RELEASED     : 03 DEC 85
  11. -- DATE LAST UPDATED : 03 DEC 85
  12. -- LOCATION          : C2MUG
  13. -- LOCATION          : ASR
  14. -- ENVIRONMENT       : VAX 11/785  VMS 4.1
  15. --= CLASSIFICATION       ===============================================--
  16. -- CATEGORY LEVEL 1  : COMPONENTS
  17. -- CATEGORY LEVEL 2  : INPUT/OUTPUT
  18. -- CATEGORY LEVEL 3  : Variable Length Direct I/O
  19. -- CATEGORY LEVEL 4  : 
  20. -- KEYWORD           : DIRECT_IO
  21. -- KEYWORD           : Varible-Length IO  
  22. -- INDEX             : Direct I/O
  23. -- INDEX             : I/O, Direct
  24. -- INDEX             : Variable-Length I/O
  25. -- INDEX             : I/O, Variable-Length
  26. -- TAXONOMY          : 
  27. -- DEPENDENCIES      : 
  28. -- SEE ALSO          : 
  29. --= FILE LISTING         ===============================================--
  30. -- FILE SPECS        : PD:<ADA.COMPONENTS>VLENGTHIO.*
  31. -- DIRECTORY DISPLAY :
  32. -- Directory   PD:<ADA.COMPONENTS>
  33. --      File Name     Byte Count  Line Count
  34. --   ---------------  ----------  ----------
  35. --   VLENGTHIO.PRO          3883          77
  36. --   VLENGTHIO.SRC        120626        3297
  37. --   ===============  ==========  ==========
  38. --     2 Files            124509        3374
  39. --= ABSTRACT             ===============================================--
  40. --         This is a  package  similar  to  DIRECT_IO  that  operates  on
  41. -- records  of  variable  length.   The body of this package may use CAIS
  42. -- utilities in the future.
  43. -- 
  44. --         This  package  allows  the user to write elements of differing
  45. -- lengths to a single direct access file.  This package can be  used  to
  46. -- write   data  of  all  types  to  a  single  file  (with  the  aid  of
  47. -- UNCHECKED_CONVERSION).  The DATA_FILE_IO package in the Ada repository
  48. -- serves as an example of how this can be accomplished.
  49. -- 
  50. --         This package also reduces the time-per-byte-of-data-transfered
  51. -- by  reducing  the  number  of  calls to the run time libraray routines
  52. -- associated with the predefined generic  package  DIRECT_IO.   This  is
  53. -- accomplished  by placing many incoming records into a large buffer and
  54. -- then writng the entire buffer to an external file as a single  element
  55. -- (vice versa for reading).  Bytes_Per_Block, the only generic parameter
  56. -- for this package, determines the size (in bytes) of this buffer.
  57. --= REVISION HISTORY     ===============================================--
  58. --
  59. -- DATE         VERSION    AUTHOR                  HISTORY
  60. -- 12/3/85      1.0         Patrick Kopson          Initial Release
  61. --= RELEASE NOTICE       ===============================================--
  62. -- This prologue must be included in all copies of this software.
  63. --
  64. -- This software is copyright by the author.
  65. --
  66. -- This software is released to the Ada community.
  67. -- This software is released to the Public Domain (note:
  68. --   software released to the Public Domain is not subject
  69. --   to copyright protection).
  70. -- Restrictions on use or distribution:  NONE
  71. --= DISCLAIMER           ===============================================--
  72. --     This software and its documentation are provided "AS IS" and
  73. -- without any expressed or implied warranties whatsoever.  No warranties
  74. -- as to performance, merchantability, or fitness for a particular
  75. -- purpose exist.
  76. --     The user is advised to test the software thoroughly before
  77. -- relying on it.  The user must assume the entire risk and liability of
  78. -- using this software.  In no event shall any person or organization of
  79. -- people be held responsible for any direct, indirect, consequential or
  80. -- inconsequential damages or lost profits.
  81. --======================================================================--
  82.